home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
SGI Freeware 2002 November
/
SGI Freeware 2002 November - Disc 2.iso
/
dist
/
fw_hylafax.idb
/
usr
/
freeware
/
catman
/
u_man
/
cat1
/
xferfaxstats.Z
/
xferfaxstats
Wrap
Text File
|
2002-07-08
|
7KB
|
128 lines
XFERFAXSTATS(${MANNUM1_8}) XFERFAXSTATS(${MANNUM1_8})
NNAAMMEE
xferfaxstats - summarize _H_y_l_a_F_A_X transmission accounting
SSYYNNOOPPSSIISS
$${{SSBBIINN}}//xxffeerrffaaxxssttaattss [ _o_p_t_i_o_n_s ] [ _f_i_l_e_s ]
DDEESSCCRRIIPPTTIIOONN
_x_f_e_r_f_a_x_s_t_a_t_s is a command script that prints a summary of
the _H_y_l_a_F_A_X accounting statistics for transmitted jobs.
The statistics can be sorted using one of several keys:
the sender's account name (default), the job tag (useful
when used for accounting purposes), the remote party's
CSI, the called phone number, the output device used for
the call, the communication speed, and the communication
data format. Statistics are read from the file
$${{SSPPOOOOLL}}//eettcc//xxffeerrffaaxxlloogg in the spooling area, unless file
names are specified on the command line.
The following table is an example of the output from _x_f_e_r_
_f_a_x_s_t_a_t_s (using the default sort key):
DDeessttiinnaattiioonn PPaaggeess TTiimmee PPgg//mmiinn EErrrrss TTyyppRRaattee TTyyppDDaattaa
cadsmith@esd.sgi.com 34 24:05 1.4 0 9600 1-D MR
ctb@corp.sgi.com 32 20:43 1.5 2 9600 2-D MR
edmark@esd.sgi.com 42 29:30 1.4 3 9600 1-D MR
fredc@mfg.sgi.com 157 1:37:52 1.6 0 9600 2-D MR
jlw@engr.sgi.com 81 57:29 1.4 1 9600 1-D MR
jlw@wpd.sgi.com 346 3:57:57 1.5 100 9600 1-D MR
karlton@asd.sgi.com 68 36:57 1.8 0 9600 1-D MR
kerrie@mfg.sgi.com 48 32:29 1.5 1 9600 2-D MR
kgraf@mfg.sgi.com 128 1:48:21 1.2 2 9600 1-D MR
kubey@wpd.sgi.com 264 3:22:13 1.3 6 9600 1-D MR
loki@wpd.sgi.com 205 2:56:45 1.2 5 9600 2-D MR
moondog@esd.sgi.com 112 1:23:01 1.3 4 9600 2-D MR
mpolen@mti.sgi.com 122 1:39:32 1.2 1 9600 1-D MR
nancyf@mfg.sgi.com 174 2:08:44 1.4 2 9600 2-D MR
paulh@mfg.sgi.com 56 1:29:24 0.6 0 9600 2-D MR
richardn@mfg.sgi.com 34 24:42 1.4 1 9600 1-D MR
rosa@corp.sgi.com 32 28:00 1.1 2 9600 1-D MR
sam@asd.sgi.com 65 46:25 1.4 5 9600 1-D MR
seth@asd.sgi.com 34 25:04 1.4 0 9600 1-D MR
--------------------------------------------------------------------------
Total 2034 25:49:13 1.3 135
The first column column shows the sort key value used (the
sender's identity here, but otherwise the destination
phone number, remote CSI, etc.). The _P_a_g_e_s column is the
total number of good pages transmitted. The _t_i_m_e column
shows the total amount of time spent transmitting. The
_P_g_/_m_i_n column displays the average transfer rate. The
_E_r_r_s column indicates how many errors were encountered
while transmitting facsimile. (Note that this statistic
does not include problems encountered while placing a
call; e.g. busy signals.) The _T_y_p_R_a_t_e column displays
the most common communication speed with which facsimile
were transmitted. The _T_y_p_D_a_t_a column shows the most com
mon data format in which facsimile data were transmitted.
By default, account names other than ``root'' and
``guest'' are automatically mapped to a canonical format
in which the host name is removed and identical addresses
in the same domain are merged together. For example,
``sam@flake.asd.sgi.com'' and ``sam@foobar.asd.sgi.com''
are both mapped to ``sam@asd.sgi.com'' with the associated
statistics accumulated. Identical account names in dif
ferent domains generate a warning; e.g.
``loki@wpd.sgi.com'' and ``loki@corp.sgi.com''. If the
--nnoommaapp option is specified, then the above mapping is not
done and account names are not altered.
OOPPTTIIOONNSS
--ccssii** Sort output by the remote party's CSI.
--ddeesstt** Sort output by the phone number called.
--ddeevv** Sort output by the output device (i.e. modem)
used.
--ffoorrmmaatt Sort output by the negotiated data format.
--jjoobb** Sort output by client-specified job tag iden
tifiers.
--nnoommaapp Supress the normal account name mapping by
which statistics for the ``root'' and
``guest'' acounts are merged and leading host
name part of domain names are stripped.
--sseenndd** Sort output by sender's account name
(default).
--ssiinnccee _t_i_m_e Show information only for the facsimile trans
mitted since the specified _t_i_m_e; where _t_i_m_e is
of the form ``MM/DD/YY HH:MM'' (the _d_a_t_e(1)
format string %D %H:%M).
--ssppeeeedd Sort output by the signalling rate.
DDIIAAGGNNOOSSTTIICCSS
``WWaarrnniinngg,, aaddddrreessss ccllaasshh,, ""%%ss"" aanndd ""%%ss""..'' During address
mapping two mapped addresses were found for the same
account name.
``WWaarrnniinngg,, wweeiirrdd uusseerr aaddddrreessss//nnaammee ""%%ss""..'' During address
mapping an address was encountered that multiple ``@''
symbols in it.
NNOOTTEESS
The sender field does not necessarily represent the sub
mitter's actual identity. For example, it reflects the
value given by the _s_e_n_d_f_a_x(${MANNUM1_8}) ``-f'' option.
Be cautious that this field is not utilized for auditing
if the fax user base is not trusted.
FFIILLEESS
${SPOOL} spooling area
etc/xferfaxlogdefault file from which to read statistics
SSEEEE AALLSSOO
_f_a_x_q(${MANNUM1_8}), _f_a_x_s_e_n_d(${MANNUM1_8}), _r_e_c_v_s_
_t_a_t_s(${MANNUM1_8}), _h_y_l_a_f_a_x_-_l_o_g(${MANNUM4_5})
May 12, 1996XFERFAXSTATS(${MANNUM1_8})